home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr50 / contrl30.zip / CONTROL.DOC next >
Text File  |  1993-06-01  |  16KB  |  338 lines
  1.                                    QBCC 3.0
  2.     Quickbasic Control Center 3.0 (c) 1993 by Levi Page, All rights reserved.
  3.  
  4.  
  5. Disclaimer:
  6.      Levi Page, makes no warranty of any kind, either express or implied,
  7. including but not limited to implied warranties of merchantability and
  8. fitness for a particular purpose, with respect to this software and
  9. accompanying documentation.
  10.  
  11.      IN NO EVENT SHALL LEVI PAGE BE LIABLE FOR ANY DAMAGES (INCLUDING DAMAGES
  12.      TO PROGRAM, SYSTEM, SOFTWARE, OR ANY OTHER LOSS THAT MAY OCCUR FROM USE
  13.      OF THIS PROGRAM) EVEN IF LEVI PAGE HAS BEEN ADVISED OF POSSIBILITY OF
  14.      SUCH DAMAGES.
  15.  
  16.  
  17.  
  18.  
  19. Distribution:
  20. Note: No fee larger than $3.00 may be charged to copy this program or
  21. distribute it, this includes the disk with QBCC 3.0.
  22.  
  23.      This program is being distributed as shareware, You are free to copy and
  24. distribute this program as long as this file accompanies it, if you try the
  25. program and use it, you MUST register your copy. In addition to rewarding me
  26. for my work and relieving you conscience, registration provides the following
  27. benefits:
  28.  
  29.      1. The current registered version on disk, registered to your name
  30.  
  31.      2. Free Updates - You will receive free updates through the mail as they
  32.         become available.
  33.  
  34.      3. The opening screen removed
  35.  
  36.      4. You get to see you name instead of UNREGISTERED on the QBCC Screen
  37.  
  38.      5. You relieve your conscience and show how honest you are!!!
  39.  
  40.  
  41.     Registration is simple. Just send $10 to the address listed and a copy of
  42.   CONTROL.FRM and you will receive the lastest REGISTERED copy of this program.
  43.  
  44. Background:
  45.      Everytime I write programs, I find myself concentrating and straining my
  46. eyes to find out where I'm at on the screen. My code was to cluttered up and I
  47. realized that I should write a program that make Quickbasic Code easier to
  48. read. So I did, and here you have it. I also come accross something about how
  49. comments take up space. I decided to add a function to remove comments along
  50. with a function to remove REM statements, all with a menu driven interface.
  51. And here you have the finished product: QBCC 3.0 (c) by Levi Page, and that's
  52. not all, it has built in DOS Functions. See for yourself and if you see it's
  53. the program for you then please register today. I have spent many, many hours
  54. writing, debuging, adding, ect. Just about all my spare time. So please reward
  55. me and register today...
  56.  
  57.  
  58. Operation:
  59.      Using QBCC 3.0 is simple. First of all just type CONTROL. You will find
  60. with an opening screen giving you information or registration and the program
  61. itself. Once you register this screen will be removed. In no way is QBCC 3.0
  62. crippled. It is a full blown version. The only difference is that it is
  63. shareware, and it has an opening screen. I am depending on YOU to be honest
  64. and if you use this program then PLEASE register. Your registration will go
  65. towards helping this project continue and letting me rely on honesty instead
  66. of crippling my programs. The shareware concept is, a man's work is worth a
  67. man's pay. You may try QBCC 3.0, and if you use it the you MUST register, or
  68. discontinue use. Now on we go: To load a program into the control center just
  69. select Load Program with the menu bar. It will load your specified program and
  70. you may now: Format, Backup, Remove Comments, or Remove REM Statements. You
  71. cannot format a program ect. without first loading it. Note: The program name
  72. must end with a .BAS extension or QBCC will refuse to load it. To format a
  73. program just select Format with the menu bar. Dont worry this is a
  74. non-destructive process. But, make a backup just in case.
  75.  
  76. Dos Commands - By selecting this you will be shown a menu with options such
  77. as, Delete file, backup load file, change directory ect. These options are
  78. self explanitory and easy to use. It is recommended that you use the backup
  79. function on your load file just in case something happens. It has tested fine
  80. on my machine and a friends, but YOU NEVER KNOW, so be careful, always back
  81. up. Most commands are self explanitory. If anyone needs any help then call
  82. 407-889-4955. Just ask for Levi Page.
  83.  
  84. Detailed Operation:
  85.      How to get started: First of all you must decide which program you want
  86.                          operate on. This file must end with .BAS or .INC to
  87.                          be able to load it into the control center. To load
  88.                          your desired file just move the highlighter by
  89.                          pressing the arrow keys on your keyboard. Highlight
  90.                          "Load a File" and press <ENTER>. You will be prompted
  91.                          for the name of the file that you would like to load.
  92.                          Enter your desired file to load and press <ENTER>.
  93.                          You will be directed to the Main Menu. Now you must
  94.                          decide what you want to do to your desired file. If
  95.                          you wish to format the program then select "Format
  96.                          Load File" with the hightlighter bar. But, before you
  97.                          do this you should backup you program just in case
  98.                          you are not happy with the way that QBCC 3.0 formats
  99.                          your program. The can be done by moving the
  100.                          highlighter bar to "DOS Commands" and press <ENTER>.
  101.                          Once this has been done you will be shown a DOS
  102.                          Commands menu. Move the highlighter bar down to
  103.                          "Backup Program" and press <ENTER>. QBCC 3.0 will
  104.                          make a backup of your load file by taking the file
  105.                          name without the extention, and adding a
  106.                          .BAK extension to the desired load file name, and
  107.                          storing the load file contents in the .BAK file.
  108.                          After this is completed move the highlighter bar to
  109.                          "Quit to Main Menu" and press <ENTER>. You will be
  110.                          returned to the main menu. Now you can select "Format
  111.                          Load FIle". You will be asked to press a key to
  112.                          continue, or asked if you would like to cancel. If
  113.                          you wish to cancel then just press the ESC key on you
  114.                          keyboard. If you press ESC you will be returned to
  115.                          the main menu, otherwise the formatting process will
  116.                          begin. How long the process will take depends on the
  117.                          speed of your computer and the size of the file. Once
  118.                          the formatting process has finished you will be
  119.                          returned to the main menu. The process is complete.
  120.                          When you load the file into your editor you will
  121.                          notice that it is easier to read. QBCC 3.0 does this
  122.                          by using special spacing in your programming code.
  123.                          This spacing is specified by the user before the
  124.                          formatting process begins. After you select "Format
  125.                          Program" from the main menu will be asked to press a
  126.                          key to continue or ESC to cancel. If you decide to
  127.                          continue you will be asked to specify the tab spacer
  128.                          size. The default is 4.
  129.  
  130. Questions and Answers:
  131.   Q:  What is the Tab Spacer?
  132.   A:  It is the size of the space that is used to print before each line and
  133.       to use when in a loop such as FOR, WHILE, ECT. So if you specify 8 then
  134.       the space that is used will look like this (        ) without the
  135.       brackets. Since QBCC 2.9 can be run on the same program with a different
  136.       tab space very easily and as many times as you want, it would be
  137.       suggested that you try different tab spaces to see what suites you best.
  138.       I would recomments 4-8.
  139.  
  140.   Q: Is there any way I can test QBCC before I run it on my program?
  141.   A: Well certainly, just type CONTROL TESTME.BAS from the DOS Prompt and the
  142.      test me file will be automaticaly loaded into the control center. Now
  143.      just select, Format Program, with the highlight bar and press <ENTER>.
  144.      You will be asked to select the tab spacer. This will determine the
  145.      spacing that the program uses. Just press <ENTER> for the default and the
  146.      process will begin. You will be given a the total line amount for the
  147.      program and the current line as the program progresses, as well as the
  148.      percentage of the program that has been formatted so far.
  149.  
  150.   Q: How is QBCC better than the competitors?
  151.   A: Well let's compare QBFORMT for QBCC.
  152.  
  153.   Menu Driven Interface:
  154.    QBFORMT: NO
  155.    QBCC   : YES
  156.  
  157.   Ability to reconize multiple commands on program statements:
  158.    QBFORMT: NO
  159.    QBCC   : YES
  160.  
  161.   Backup, Print, Database, Features:
  162.    QBFORMT: NO  /  NO  /  NO
  163.    QBCC   : YES /  YES  /  YES
  164.  
  165.   DOS Functions:
  166.    QBFORMT: NO
  167.    QBCC   : YES
  168.  
  169.   Cost:
  170.    QBFORMT: $10.00
  171.    QBCC   : $10.00
  172.  
  173.   Q: Why is the ability to reconize multiple commands important?
  174.   A: This is another reason QBCC is better than the rest. Heres an example...
  175.  
  176.  
  177.   START:
  178.   FOR X=1 TO 10
  179.   PRINT X
  180.   PRINT X-1
  181.   PRINT X+1:NEXT X  ' Notice how this line ends the loop with two commands.
  182.   PRINT "THIS DEMO IS OVER"
  183.   PRINT "PRESS ANYKEY TO CONTINUE..."
  184.   WHILE INKEY$=""
  185.   PRINT ".";:WEND
  186.   PRINT "BYE, BYE...":END
  187.  
  188.   The competitor puts this:
  189.     START:
  190.         FOR X=1 to 10
  191.             PRINT X
  192.             PRINT X-1
  193.             PRINT X+1:NEXT X ' IT DID NOT RECONIZE THIS STATEMENT
  194.             PRINT "THIS DEMO IS OVER"
  195.             PRINT "PRESS ANKEY TO CONTINUE..."
  196.             WHILE INKEY$=""
  197.                 PRINT ".";:WEND ' IT DID NOT RECONIZE THE WEND STATEMENT
  198.                 PRINT "BYE, BYE...":END
  199.  
  200.   QBCC Puts:
  201.  
  202. START:
  203.     FOR X=1 TO 10
  204.         PRINT X
  205.         PRINT X-1
  206.         PRINT X+1:NEXT X ' IT RECONIZES IT
  207.     PRINT "THIS DEMO IS OVER"
  208.     PRINT "PRESS ANYKEY TO CONTINUE..."
  209.     WHILE INKEY$=""
  210.         PRINT ".";:WEND
  211.     PRINT "BYE, BYE...":END
  212.  
  213.     It is especially important to be able to do this, because after going
  214.     through a full progrom with multiple command loops, the competitor could
  215.     have your program leaving the screen. QBCC does not.
  216.  
  217.  
  218. Database:
  219.      The new database feature allows you to keep a database of your current
  220. ten projects to allow you to access them quickly without changing directorys
  221. or entering the name. To add a record just go to the database menu and select
  222. option "A" it will ask you for the directory and the name of the file. Once
  223. this is done just enter 0-9 for the record to save to. Once this is done the
  224. file can be easily loaded by pressing 0-9 on your keyboard, depending on which
  225. file you are trying to load. The commands are self explanitory and easy to
  226. use. Try it out for your self, you won't be disappointed...
  227.  
  228. New in Version 1.1:
  229.      Minor Changes to Sreeens
  230.  
  231. New in Version 1.2:
  232.      You may now PRINT the load file to the printer.
  233.  
  234. New in Version 2.0:
  235.      Major Upgrade!!! You may now keep an extensive database of your
  236. Quickbasic files. You may keep a database of up to 10 .BAS programs. It allows
  237. you to easily load one of the nine files without typing the directory of the
  238. name of the file. Once the file is stored it may be easily accessed with the
  239. press of a key. Or you can just load it without the database from the main
  240. menu. The database is a real time saver, and it makes a great tool to maintain
  241. your current ten projects. Or if you just want to load a certain file then
  242. goto the main menu and select "Load a File", with the menu bar and press
  243. enter. The database is easy to use and maintain. It gives you quick access to
  244. your current 10 projects. You may add, erase, ect. to the database very quickly
  245. and easily.
  246.  
  247. New in Version 2.1:
  248.      Added database functions.
  249.  
  250. New in Version 2.2:
  251.      Minor changes to screens and a minor bug fix in the database menu when
  252.      loading load file number 6.
  253.  
  254. New in Version 2.5: Added the ability to reconize tabs in program code.
  255.                     Technically this was a major upgrade considering the
  256.                     program would not work properly when it came accross tabs
  257.                     in the program code.
  258.  
  259. New in Version 2.7: Fixed bug with the backup option. Added support for nested
  260.                     loops and multiple command lines.
  261.  
  262. New in Version 2.9: Command Line Support and the ability to specify the tab
  263.                     spacer size.
  264.  
  265. New in Version 3.0: Improved formatter. Added status screen for the formatter.
  266.                     It now gives you the total line amount for the program,
  267.                     current line, and percentage completed. Improved
  268.                     documentation. Added the ability to load a file into the
  269.                     control center from the DOS prompt. Major speed
  270.                     improvement. Using tricks of the trade, QBCC now has
  271.                     blazing speed. QBCC is now almost 700% faster.
  272.  
  273. Acknowledgements:
  274.      I would like to thank Steve Page, and no he is not related to me, of
  275.      Speakeasy BBS (407) 291 - 4626, over 2.1 Gigs Online, for helping me test
  276.      this program. Thanks STEVE, I really appreciate all of your help... I
  277.      would also like to thank Dale Couch for testing my program for me.
  278.  
  279.  
  280. Current Version:
  281.      The current version will always be available on the Speakeasy BBS.
  282.      The phone number is (407) 291 - 4626. I will be starting my own bbs soon,
  283.      so stayed tuned to the Quickbasic Confernece for details. I will post a
  284.      message as soon as I finish setting it up.
  285.  
  286.  
  287. Errors:
  288.  
  289.      Printer Errors - These errors occur if your printer is not on-line,
  290.      out-of-paper or other misc. errors that may occur while printing. If one
  291.      occurs you will get a printer error and you will be asked to fix the
  292.      problem and try again.
  293.  
  294.      File Errors - If a file has not been loaded into the Control Center then
  295.      you cannot do anything to it. The only way to interface with a file is to
  296.      load it first.
  297.  
  298.      Invalid Extension - You will get an error if you try to load a non -
  299.      Basic file. Meaning the file you load must end with a .BAS extension.
  300.  
  301.      Shell Errors - In order to complete certain operations, QBCC 2.7 must be
  302.      able to access certain functions. It is recommended that you have a
  303.      SET COMSPEC=C:\DOS\COMMAND.COM ' or the directory containing COMMAND.COM.
  304.      If COMMAND.COM cannot be found then your load file will be stored in
  305.      NEWFILE.BAS. There is no way around this so make sure your COMMAND.COM
  306.      file can be found and always use the backup function at the DOS menu.
  307.  
  308.  
  309. Fee:
  310.      Quickbasic Control Center 3.0 is Shareware and it is not free, so if you
  311.      decide to use it then you must pay a fee of $10.00. This includes
  312.      shipping so $10.00 is all you need to pay. If you would like to purchase
  313.      QBCC 2.5, then fill out CONTROL.FRM and send it to the below address.
  314.  
  315. Commercial Site License:
  316.      The commercial fee for Quickbasic Control Center 3.0 is $30.00, this will
  317.      allow you to use Quickbasic Control Center 3.0 on four(4) Computers at a
  318.      time. CONTROL.FRM contains information that you must abide by and then
  319.      you must sign you name at the end of the form where it asks for you
  320.      signature.
  321.  
  322. Note:
  323.     The name that you register with is the name that will be displayed on the
  324.     program screen.
  325.  
  326.  
  327. Note: Call 407-889-4955 for information
  328.  
  329.  
  330.  
  331.                                Levi Page
  332.                        RE: QBCC 3.0 Registration
  333.                            210 Caldwell St.
  334.                           Apopka, Fl. 32712
  335.  
  336.  
  337.  Need Anything? Call 407-889-4955
  338.